# Delete folder

Delete a folder by ID.

Endpoint: DELETE /entities/folders/{id}
Version: 1.0.0

## Path parameters:

  - `id` (integer, required)
    Delete a folder

## Response 200 fields (application/vnd.treasuredata.v1+json):

  - `data` (object, required)

  - `data.id` (string, required)

  - `data.type` (string, required)
    Enum: "folder-segment"

  - `data.attributes` (object, required)

  - `data.attributes.audienceId` (string, required)
    ID of the parent audience. For composable folders this carries
the composable audience id; the complete-vs-composable
discriminator lives on the parent audience entity, not on the
folder.

  - `data.attributes.name` (string, required)

  - `data.attributes.description` (string, required)

  - `data.attributes.createdAt` (string, required)

  - `data.attributes.updatedAt` (string, required)

  - `data.attributes.enrichments` (object)

  - `data.attributes.rule` (object)

  - `data.attributes.permissions` (object, required)

  - `data.attributes.permissions.view` (boolean)

  - `data.attributes.permissions.edit` (boolean)

  - `data.relationships` (object, required)

  - `data.relationships.children` (object)

  - `data.relationships.children.data` (array)

  - `data.relationships.children.data.data` (object)

  - `data.relationships.children.data.data.id` (string, required)

  - `data.relationships.children.data.data.type` (string, required)
    Enum: "folder-segment", "segment-batch", "segment-realtime", "composable-segment", "funnel", "predictive-segment", "token", "journey"

  - `data.relationships.parentFolder` (object)

  - `data.relationships.parentFolder.data` (object)

  - `data.relationships.parentFolder.data.id` (string, required)

  - `data.relationships.parentFolder.data.type` (string, required)
    Enum: "folder-segment"

  - `data.relationships.createdBy` (object)

  - `data.relationships.createdBy.data` (object)

  - `data.relationships.createdBy.data.id` (string, required)

  - `data.relationships.createdBy.data.type` (string, required)
    Enum: "user"

  - `included` (array, required)

  - `included.id` (string, required)

  - `included.type` (string, required)
    Enum: "user"

  - `included.attributes` (object, required)

  - `included.attributes.tdUserId` (string, required)

  - `included.attributes.name` (string, required)

## Response 400 fields (application/json):

  - `errors` (array, required)

  - `errors.code` (string, required)
    Error code in string
    Enum: "bad-parameter-error"

  - `errors.status` (string, required)
    Status code for error
    Enum: "400"

  - `errors.detail` (string, required)
    Detailed error message
    Example: SegmentFolder View Permission Required

  - `errors.source` (object)

  - `errors.source.pointer` (string, required)
    Pointer to invalid parameter
    Example: /attributes/segments/

  - `errors.meta` (object)

  - `errors.meta.parameterCode` (string, required)
    Detailed validation error code
    Enum: "SHOULD_BE_ARRAY", "INVALID_FORMAT"

## Response 403 fields (application/json):

  - `errors` (array, required)

  - `errors.code` (string, required)
    Error code in string
    Enum: "permission-error"

  - `errors.status` (string, required)
    Status code for error
    Enum: "403"

  - `errors.detail` (string, required)
    Detailed error message
    Example: SegmentFolder View Permission Required

  - `errors.meta` (object)
    Meta info for storing permissionCode. Note that in some cases, meta can be null.

  - `errors.meta.permissionCode` (string, required)
    Detailed validation error code
    Enum: "SEGMENT_FOLDER_VIEW_REQUIRED", "SEGMENT_FOLDER_EDIT_REQUIRED"

## Response 404 fields (application/json):

  - `errors` (array, required)

  - `errors.code` (string, required)
    Error code in string
    Enum: "record-not-found-error"

  - `errors.status` (string, required)
    Enum: "404"

  - `errors.detail` (string, required)
    Detailed error message
    Example: Record not found

## Response 409 fields (application/json):

  - `errors` (object, required)
    Error messages. Key name can be vary depends on endpoint.

  - `errors.id` (array)

  - `errors.deletion` (array)

  - `referencedBySegments` (array)
    This field exists only for segment deletion

  - `referencedBySegments.id` (string)
    Other Segment ID referencing this segment

  - `referencedByPredictiveSegments` (array)
    This field exists only for segment deletion

  - `referencedByPredictiveSegments.id` (string)
    PredictiveSegment ID referencing this segment